home *** CD-ROM | disk | FTP | other *** search
iiiillllLLLLiiiinnnnkkkk((((3333)))) IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll iiiillllLLLLiiiinnnnkkkk((((3333)))) NNNNAAAAMMMMEEEE iiiillllLLLLiiiinnnnkkkk - base class abstraction for object chaining IIIINNNNHHHHEEEERRRRIIIITTTTSSSS FFFFRRRROOOOMMMM This is a base class and therefore has no inheritance. HHHHEEEEAAAADDDDEEEERRRR FFFFIIIILLLLEEEE #include <il/ilCdefs.h> CCCCLLLLAAAASSSSSSSS DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN ilLink is the base class that implements the ImageVision Library (IL) chaining model. The ilLink class defines the mechanism for chaining objects together; objects are linked in a forward (child) or back (parent) relation. Allowing for such relations allows IL to specify image objects as inputs or outputs to other objects. All IL image objects are indirectly derived from ilLink. The ilLink base class implements the IL chaining model by defining the parent and child lists and the necessary functions to manage the lists. Additionally, ilLink provides a mechanism for managing the state and status of an ilLink. UUUUssssiiiinnnngggg iiiillllLLLLiiiinnnnkkkk ilLink is a base class used for chaining other ilLink derived objects. It is intended to be used as a base class for deriving new types of chainable objects. The ilLink class provides protected and public member functions. The protected functions can only be called from a derived class. They may be used, for example, to query or set its state and status. The public functions can be called from either a derived class or an application program. The public functions are used to manage the parent and child links of the ilLink object. DDDDeeeeffffiiiinnnniiiinnnngggg aaaannnndddd aaaacccccccceeeessssssssiiiinnnngggg oooobbbbjjjjeeeecccctttt ddddeeeessssccccrrrriiiippppttttiiiioooonnnnssss Methods are provided to obtain the class and base class names of objects derived from ilLink. There are also methods to get and set a description string for objects derived from ilLink. Finally, there is a default description string for a particular subclass that is used when no description string has been explicitly set. UUUUssssiiiinnnngggg pppprrrrooooppppeeeerrrrttttiiiieeeessss Methods are provided to set and query property values by name on an object derived from ilLink. A property value can be an integer, a floating point number, or a pointer. The name is a character string. This feature enables one to tag objects with arbitrary attributes. There are three scope levels provided for setting and querying property values: the object instance, the object class, and a global scope. When retrieving a property value, more than one scope can be specified. If PPPPaaaaggggeeee 1111 iiiillllLLLLiiiinnnnkkkk((((3333)))) IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll iiiillllLLLLiiiinnnnkkkk((((3333)))) so, then each of the specified scopes is searched in this order: the object instance scope, then the object class scope, then the global scope. CCCCLLLLAAAASSSSSSSS MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN SSSSUUUUMMMMMMMMAAAARRRRYYYY DDDDeeeessssttttrrrruuuuccccttttoooorrrr void ilLinkDelete(ilLink *link) MMMMaaaannnnaaaaggggiiiinnnngggg tttthhhheeee PPPPaaaarrrreeeennnntttt aaaannnndddd CCCChhhhiiiilllldddd rrrreeeellllaaaattttiiiioooonnnnssss int ilGetNumParents(ilLink* link) ilLink* ilGetDirectParent(ilLink* link, int index) ilLink* ilGetParent(ilLink* link, int index) ilStatus ilSetParent(ilLink* link, ilLink* parent, int idx) ilStatus ilRemoveParent(ilLink* link, int idx) int ilGetNumChildren(ilLink* link) void ilSetEnabled(ilLink* link, int enable) int ilIsEnabled(ilLink* link) void ilSetDisabledIndex(ilLink* link, int parentIndex) int ilGetDisabledIndex(ilLink* link) void ilClearSet(ilLink* link, int mask) ilLink* ilGetRelatedChild(int type) int ilGetRelatedType() void ilSetRelatedType(int rtype, int ignoreDisable) int ilGetRelatedDelete() void ilSetRelatedDelete(int del) int ilLinkIsRelated(ilLink *obj) MMMMaaaannnnaaaaggggiiiinnnngggg ssssttttaaaatttteeee int ilIsAltered(int mask) int ilIsSet(int mask) void ilIsAllowed(int mask) ilStatus ilGetStatus(ilLink* link) void ilClearStatus(ilLink* link) unsigned int ilLinkGetGenerationID(ilLink *obj) AAAAcccccccceeeessssssssiiiinnnngggg oooobbbbjjjjeeeecccctttt ddddeeeessssccccrrrriiiippppttttiiiioooonnnnssss char* ilGetClassName(ilLink* link, int parentIdx) char* ilGetDescription(ilLink* link, int ignoreDefault) ilStatus ilSetDescription(ilLink* link, char* desc, ilScope scope) AAAAcccccccceeeessssssssiiiinnnngggg oooobbbbjjjjeeeecccctttt pppprrrrooooppppeeeerrrrttttyyyy lllliiiissssttttssss PPPPaaaaggggeeee 2222 iiiillllLLLLiiiinnnnkkkk((((3333)))) IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll iiiillllLLLLiiiinnnnkkkk((((3333)))) int ilGetIntProp(ilLink* link, char* s, ilScope scope) float ilGetFloatProp(ilLink* link, char* s, ilScope scope) void* ilGetPtrProp(ilLink* link, char* s, ilScope scope) ilStatus ilSetIntProp(ilLink* link, char* s, int i, ilScope scope) ilStatus ilSetFloatProp(ilLink* link, char* s, float f, ilScope scope) ilStatus ilSetPtrProp(ilLink* link, char* s, void* p, ilScope scope) ilStatus ilRemoveProp(ilLink* link, char* s, ilScope scope) HHHHaaaarrrrddddwwwwaaaarrrreeee hhhhiiiinnnntttt mmmmaaaannnnaaaaggggeeeemmmmeeeennnntttt ilStatus ilSetHwHint(ilHwHint* hint, int adopt=FALSE) ilStatus ilSetHwIntHint(int hintID, int val) ilStatus ilSetHwIntHintName(const char* hintName, int val) const ilHwHint* ilGetHwHint(int hintID) const ilHwHint* ilGetHwHintName(const char* hintName) int ilGetHwIntHint(int hintID, int* val) int ilGetHwIntHintName(const char* hintName, int* val) ilStatus ilRemoveHwHint(int hintID) ilStatus ilRemoveHwHintName(const char* hintName) FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNNSSSS iiiillllLLLLiiiinnnnkkkkDDDDeeeelllleeeetttteeee(((()))) void ilLinkDelete(ilLink *link) Deletes the object referenced by _l_i_n_k. aaaalllltttteeeerrrrAAAAccccttttiiiioooonnnn(((()))) virtual void alterAction() _p_r_o_t_e_c_t_e_d This virtual is called when an object is first marked altered after a reset. It can be defined to handle special circumstances (like recovering memory in ilMemCacheImg) but most users should use the rrrreeeesssseeeetttt() virtual to handle alterations to an object. cccclllleeeeaaaarrrrSSSSeeeetttt(((()))) void ilClearSet(ilLink* link, int mask) Resets a predefined parameter by the specified _m_a_s_k. cccclllleeeeaaaarrrrSSSSttttaaaattttuuuussss(((()))) void ilClearStatus(ilLink *link) PPPPaaaaggggeeee 3333 iiiillllLLLLiiiinnnnkkkk((((3333)))) IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll iiiillllLLLLiiiinnnnkkkk((((3333)))) Clears the status returned by ggggeeeettttSSSSttttaaaattttuuuussss(((()))) to ilOKAY. ggggeeeettttCCCCllllaaaassssssssNNNNaaaammmmeeee(((()))) virtual char* getClassName(int parentIdx=0) char* ilGetClassName(ilLink* link, int parentIdx) Returns the name of the object's class as a character string. The _p_a_r_e_n_t_I_d_x parameter allows the name of a parent class to be retrieved; it's value specifies the number of hops up the inheritance chain. A value of zero (the default) fetches this class's name, a value of one returns the immediate parent class's name, and so on. char* ilGetDescription(ilLink* link, int ignoreDefault) Returns the object's description string. If no description string has been defined (by sssseeeettttDDDDeeeessssccccrrrriiiippppttttiiiioooonnnn), then the default description string is returned unless the flag _i_g_n_o_r_e_D_e_f_a_u_l_t is _T_R_U_E in which case _N_U_L_L is returned. ggggeeeettttDDDDiiiirrrreeeeccccttttPPPPaaaarrrreeeennnntttt(((()))) int ilGetDirectParent(ilLink *link, int index) Returns a pointer to the ilLink at index _i_n_d_e_x in the parent list, even if that parent has been disabled with setEnabled(FALSE). NULL is returned if there is no ilLink at the specified index. See ggggeeeettttPPPPaaaarrrreeeennnntttt(). ggggeeeettttDDDDiiiissssaaaabbbblllleeeeddddIIIInnnnddddeeeexxxx(((()))) int ilGetDisabledIndex(ilLink* link) Returns the index of the parent to be used in place of this object when it is disabled. See sssseeeettttDDDDiiiissssaaaabbbblllleeeeddddIIIInnnnddddeeeexxxx(), iiiissssEEEEnnnnaaaabbbblllleeeedddd() and sssseeeettttEEEEnnnnaaaabbbblllleeeedddd(). ggggeeeettttFFFFllllooooaaaattttPPPPrrrroooopppp(((()))) float ilGetFloatProp(ilLink* link, char* s, ilScope scope) Return the float property value associated with the string _s or _0 if no such property has been defined. The _s_c_o_p_e argument specifies the search range for property lookup. See the explanation of _s_c_o_p_e under ggggeeeettttIIIInnnnttttPPPPrrrroooopppp(). PPPPaaaaggggeeee 4444 iiiillllLLLLiiiinnnnkkkk((((3333)))) IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll iiiillllLLLLiiiinnnnkkkk((((3333)))) ggggeeeettttGGGGeeeennnneeeerrrraaaattttiiiioooonnnnIIIIDDDD(((()))) unsigned int ilLinkGetGenerationID(ilLink *obj) Returns the ID of _o_b_j. The ID is a number unique across all instantiated objects derived from ilLink. The ID changes every time the object is altered, so it may be used for an inexpensive check of whether an object has changed. ggggeeeettttHHHHwwwwHHHHiiiinnnntttt(((()))) const ilHwHint* ilGetHwHint(ilLink* link, int hintID) const ilHwHint* ilGetHwHint(ilLink* link, const char* hintName) int ilGetHwIntHint(int hintID, int* val) int ilGetHwIntHintName(const char* hintName, int* val) This function returns a pointer to the ilHwHint associated with either the given _h_i_n_t_I_D or _h_i_n_t_N_a_m_e. If the requested hint has not been set on this object (using sssseeeettttHHHHwwwwHHHHiiiinnnntttt()), then the global hints are searched for this hint. If the hint has also not been set globally, then this method returns NULL. The ggggeeeettttHHHHwwwwIIIInnnnttttHHHHiiiinnnntttt() methods provide a simpler interface to access integer hints that were previously set using sssseeeettttHHHHwwwwIIIInnnnttttHHHHiiiinnnntttt() or iiiillllHHHHwwwwSSSSeeeettttGGGGlllloooobbbbaaaallllIIIInnnnttttHHHHiiiinnnntttt(). The ggggeeeettttHHHHwwwwIIIInnnnttttHHHHiiiinnnntttt() methods return _T_R_U_E if the hint is defined, and sets the integer pointed-to by the _v_a_l parameter to the hint value if it is defined. The contents of _v_a_l are unchanged if the hint is undefined. See iiiillllHHHHwwwwHHHHiiiinnnntttt((((3333)))) for specific information on IL- recognized hints. int ilGetIntProp((((iiiillllLLLLiiiinnnnkkkk**** lllliiiinnnnkkkk,,,, cccchhhhaaaarrrr**** ssss,,,, iiiillllSSSSccccooooppppeeee ssssccccooooppppeeee)))) Return the integer property value associated with the string _s or _0 if no such property has been defined. The _s_c_o_p_e argument specifies the search range for property lookup. It can be any logically OR'ed combination of _i_l_I_n_s_t_a_n_c_e_S_c_o_p_e, _i_l_C_l_a_s_s_S_c_o_p_e, and _i_l_G_l_o_b_a_l_S_c_o_p_e. If _i_l_I_n_s_t_a_n_c_e_S_c_o_p_e is specified, then the object's property set is searched. If _i_l_C_l_a_s_s_S_c_o_p_e is specified, then the object's class property set is searched. Finally, if _i_l_G_l_o_b_a_l_S_c_o_p_e is specified, then the global property set is searched. If more than one of of the search scopes is specified, then each of the specified scopes is searched in this order: the object instance scope, then the object class scope, then the global scope. ggggeeeettttNNNNuuuummmmCCCChhhhiiiillllddddrrrreeeennnn(((()))) int ilGetNumChildren(ilLink *link) PPPPaaaaggggeeee 5555 iiiillllLLLLiiiinnnnkkkk((((3333)))) IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll iiiillllLLLLiiiinnnnkkkk((((3333)))) Returns the length of the children list. ggggeeeettttNNNNuuuummmmPPPPaaaarrrreeeennnnttttssss(((()))) int ilGetNumParents(ilLink *link) Returns the length of the parent list. ggggeeeettttPPPPaaaarrrreeeennnntttt(((()))) int ilGetParent(ilLink *link, int index) Returns a pointer to the ilLink at index _i_n_d_e_x in the parent list. NULL is returned if there is no ilLink at the specified index. If the selected parent of this object has been disabled with setEnabled(FALSE), the actual parent returned will be the parent's parent designated with sssseeeettttDDDDiiiissssaaaabbbblllleeeeddddIIIInnnnddddeeeexxxx(). If that grandparent is also disabled the process will be repeated until an enabled (great- ...)great-grandparent is found or there are no more ancestors, in which case NULL is returned. See sssseeeettttEEEEnnnnaaaabbbblllleeeedddd() and sssseeeettttDDDDiiiissssaaaabbbblllleeeeddddIIIInnnnddddeeeexxxx(). ggggeeeettttPPPPttttrrrrPPPPrrrroooopppp(((()))) void* ilGetPtrProp(ilLink* link, char* s, ilScope scope) Return the pointer property value associated with the string _s or _N_U_L_L if no such property has been defined. The _s_c_o_p_e argument specifies the search range for property lookup. See the explanation of _s_c_o_p_e under ggggeeeettttIIIInnnnttttPPPPrrrroooopppp(). ggggeeeettttRRRReeeellllaaaatttteeeeddddCCCChhhhiiiilllldddd(((()))) ilLink* ilGetRelatedChild(int type) Returns a pointer to the child with the indicated related type, if any, or NULL otherwise. ggggeeeettttRRRReeeellllaaaatttteeeeddddDDDDeeeelllleeeetttteeee(((()))) int ilGetRelatedDelete() Returns TRUE if and only if this image has been marked as a related child to be deleted automatically when the parent is reset. PPPPaaaaggggeeee 6666 iiiillllLLLLiiiinnnnkkkk((((3333)))) IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll iiiillllLLLLiiiinnnnkkkk((((3333)))) ggggeeeettttRRRReeeellllaaaatttteeeeddddTTTTyyyyppppeeee(((()))) int ilGetRelatedType() Returns the related type of this image or zero if the image is not a related child. ggggeeeettttSSSSttttaaaattttuuuussss(((()))) ilStatus ilGetStatus(ilLink* link) Returns the value of the status data member. The possible constants that can be returned are defined in the <_i_l/_i_l_E_r_r_o_r._h> header file. iiiinnnnPPPPrrrrooooggggrrrreeeessssssss(((()))) int inProgress() _p_r_o_t_e_c_t_e_d Returns TRUE if the _i_l_L_i_n_k_P_a_r_a_m value, _i_l_L_P_i_n_P_r_o_g_r_e_s_s, is set. int ilIsAllowed(int mask) Returns TRUE if the parameter _m_a_s_k is set in the _a_l_l_o_w_e_d data member. The parameter, _m_a_s_k, must be a valid ilLinkParam value, as defined in the header file <_i_l/_i_l_L_i_n_k._h>. iiiissssAAAAlllltttteeeerrrreeeedddd(((()))) int ilIsAltered(int mask) Returns TRUE if the parameter _m_a_s_k is set in the _a_l_t_e_r_e_d data member. The parameter, _m_a_s_k, must be a valid ilLinkParam value, as defined in the header file <_i_l/_i_l_L_i_n_k._h>. iiiissssEEEEnnnnaaaabbbblllleeeedddd(((()))) int ilIsEnabled(ilLink* link) Returns TRUE if this object is enabled (the default state), FALSE otherwise. See sssseeeettttEEEEnnnnaaaabbbblllleeeedddd() for details on what it means to be enabled or disabled. iiiissssRRRReeeellllaaaatttteeeedddd(((()))) PPPPaaaaggggeeee 7777 iiiillllLLLLiiiinnnnkkkk((((3333)))) IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll iiiillllLLLLiiiinnnnkkkk((((3333)))) int ilLinkIsRelated(ilLink *obj) Returns FALSE if the object is not related; TRUE otherwise. iiiissssSSSSeeeetttt(((()))) int ilIsSet(int mask) Returns TRUE if the _i_l_L_i_n_k_P_a_r_a_m specified by _m_a_s_k has been previously set. rrrreeeemmmmoooovvvveeeeHHHHwwwwHHHHiiiinnnntttt(((()))) ilStatus ilRemoveHwHint(ilLink* link, int hintID) ilStatus ilRemoveHwHint(ilLink* link, const char* hintName) This method removes the hardware hint associated with the given hintID or hintName. rrrreeeemmmmoooovvvveeeePPPPaaaarrrreeeennnntttt(((()))) ilStatus ilRemoveParent(ilLink* link, int index) This function removes the ilLink indexed by _i_n_d_e_x and marks this IilLink objects's state as _a_l_t_e_r_e_d. rrrreeeemmmmoooovvvveeeePPPPrrrroooopppp(((()))) ilStatus ilRemoveProp(ilLink* link, char* s, ilScope scope) Remove the property associated with the string _s from the specified property set. The _s_c_o_p_e argument selects the property set from which the property is removed. See the explanation of _s_c_o_p_e under sssseeeettttPPPPrrrroooopppp(). The object is not marked altered as a result of rrrreeeemmmmoooovvvveeeePPPPrrrroooopppp(). sssseeeettttDDDDeeeessssccccrrrriiiippppttttiiiioooonnnn(((()))) ilStatus ilSetDescription(ilLink* link, char* desc, ilScope scope) Set the object's description string to be that pointed to by _d_e_s_c. Later calls to ggggeeeettttDDDDeeeessssccccrrrriiiippppttttiiiioooonnnn() will return this string. The argument _s_c_o_p_e can have value _i_l_I_n_s_t_a_n_c_e_S_c_o_p_e or _i_l_C_l_a_s_s_S_c_o_p_e. In the former case, the description string applies to the object only. In the latter case, it applies to all objects of that class. This method returns _i_l_O_K_A_Y if the value of _s_c_o_p_e has value PPPPaaaaggggeeee 8888 iiiillllLLLLiiiinnnnkkkk((((3333)))) IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll iiiillllLLLLiiiinnnnkkkk((((3333)))) _i_l_I_n_s_t_a_n_c_e_S_c_o_p_e or _i_l_C_l_a_s_s_S_c_o_p_e and _i_l_U_N_S_U_P_P_O_R_T_E_D otherwise. The object is not marked altered as a result of sssseeeettttDDDDeeeessssccccrrrriiiippppttttiiiioooonnnn(). sssseeeettttDDDDiiiissssaaaabbbblllleeeeddddIIIInnnnddddeeeexxxx(((()))) void ilSetDisabledIndex(ilLink* link, int parentIndex) Sets the index of the parent to be used in place of this object, when it is disabled, to _p_a_r_e_n_t_I_n_d_e_x. The default of this index upon construction is zero. See ggggeeeettttDDDDiiiissssaaaabbbblllleeeeddddIIIInnnnddddeeeexxxx(), iiiissssEEEEnnnnaaaabbbblllleeeedddd() and sssseeeettttEEEEnnnnaaaabbbblllleeeedddd(). sssseeeettttEEEEnnnnaaaabbbblllleeeedddd(((()))) void ilSetEnabled(ilLink* link, int enable) This function sets the enabled status of this object to _e_n_a_b_l_e. If _e_n_a_b_l_e is TRUE, then this object will participate normally in a chain of objects. If _e_n_a_b_l_e is FALSE, a chain with this object in it will behave as if the object were removed from the chain; this object's children's parents will appear to the parent of this object designated with sssseeeettttDDDDiiiissssaaaabbbblllleeeeddddIIIInnnnddddeeeexxxx(). A disabled object that is directly accessed (say via ccccooooppppyyyyTTTTiiiilllleeee(), will behave normally, only accesses through a child's ggggeeeettttPPPPaaaarrrreeeennnntttt() method are affected. Since ilView uses ggggeeeettttPPPPaaaarrrreeeennnntttt() to find its input, even the end of a chain being displayed through ilDisplay/ilView can be successfuly disabled. The default enable state for a newly constucted object is TRUE. See sssseeeettttDDDDiiiissssaaaabbbblllleeeeddddIIIInnnnddddeeeexxxx(), ilDisplay and ilView. ilStatus ilSetHwHint(ilLink* link, ilHwHint* hint, int adopt) ilStatus ilSetHwIntHint(int hintID, int val) ilStatus ilSetHwIntHintName(const char* hintName, int val) Set a hardware hint for this image. The adopt argument indicates whether this ilLink should adopt the responsibility for releasing the storage associated with the hint. If set to TRUE then the ilLink will ensure that the hint is deleted when no longer needed. The setHwIntHint methods provide a simpler interface to set integer-valued hints. Hints that are set in this manner are always adopted and managed internally. The hintID is a global identifier that is associated with the particular hint name. It can be found using the function ilHwFindHintID. sssseeeettttPPPPaaaarrrreeeennnntttt(((()))) int ilSetParent(ilLink* link, ilLink* parent, int index) PPPPaaaaggggeeee 9999 iiiillllLLLLiiiinnnnkkkk((((3333)))) IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll iiiillllLLLLiiiinnnnkkkk((((3333)))) Replaces the ilLink at _i_n_d_e_x with _p_a_r_e_n_t and sets the state to _a_l_t_e_r_e_d. If _p_a_r_e_n_t already exists at _i_n_d_e_x, then ilOKAY is returned and the state is not altered. sssseeeettttPPPPrrrroooopppp(((()))) ilStatus ilSetIntProp(ilLink* link, char* s, int i, ilScope scope) ilStatus ilSetFloatProp(ilLink* link, char* s, float f, ilScope scope) ilStatus ilSetPtrProp(ilLink* link, char* s, void* p, ilScope scope) Assign a property value associated with the string _s. The property value can be an integer, a floating point number, or a pointer. The functions iiiillllSSSSeeeettttIIIInnnnttttPPPPrrrroooopppp(), iiiillllSSSSeeeettttFFFFllllooooaaaattttPPPPrrrroooopppp(), and iiiillllSSSSeeeettttPPPPttttrrrrPPPPrrrroooopppp() select each of these three possibilities. The _s_c_o_p_e argument selects the property set under which the property value is stored. It can be one of _i_l_I_n_s_t_a_n_c_e_S_c_o_p_e, _i_l_C_l_a_s_s_S_c_o_p_e, or _i_l_G_l_o_b_a_l_S_c_o_p_e. If _i_l_I_n_s_t_a_n_c_e_S_c_o_p_e is specified, then the object's property set is selected. If _i_l_C_l_a_s_s_S_c_o_p_e is specified, then the object's class property set is selected. Finally, if _i_l_G_l_o_b_a_l_S_c_o_p_e is specified, then the global property set is selected. The function returns _i_l_O_K_A_Y if _s_c_o_p_e is one of _i_l_I_n_s_t_a_n_c_e_S_c_o_p_e, _i_l_C_l_a_s_s_S_c_o_p_e, and _i_l_G_l_o_b_a_l_S_c_o_p_e. Otherwise, it returns _i_l_U_N_S_U_P_P_O_R_T_E_D. The object is not marked altered as a result of sssseeeettttPPPPrrrroooopppp(). sssseeeettttPPPPrrrrooooppppAAAAlllltttteeeerrrreeeedddd(((()))) void setPropAltered(iflName* propName) _p_r_o_t_e_c_t_e_d Sets all children (and descendants) that have the property defined and non-zero to be altered. This method is used by the ilHwHints mechanism to propagate hint change notifications to all objects that have been marked as being interested in hint changes. sssseeeettttRRRReeeellllaaaatttteeeeddddDDDDeeeelllleeeetttteeee(((()))) void ilSetRelatedDelete(int del) Set the related child delete flag to _d_e_l. If the flag is set TRUE then this image will be deleted automatically when the parent is reset. sssseeeettttRRRReeeellllaaaatttteeeeddddTTTTyyyyppppeeee(((()))) void ilSetRelatedType(int rtype, int ignoreDisable) Marks an image as related child of type _r_t_y_p_e. If _i_g_n_o_r_e_D_i_s_a_b_l_e is TRUE then the image will not pay attention to the disable status of its immediate parent, thus ensuring that it is only associated with PPPPaaaaggggeeee 11110000 iiiillllLLLLiiiinnnnkkkk((((3333)))) IIIImmmmaaaaggggeeeeVVVViiiissssiiiioooonnnn LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll iiiillllLLLLiiiinnnnkkkk((((3333)))) that particular image. SSSSEEEEEEEE AAAALLLLSSSSOOOO ilImage, iflList, ilPropSet, ilWatchedObject, ilHwHint, <_i_l/_i_l_L_i_n_k._h>, <_i_l/_i_l_E_r_r_o_r._h>, <_i_l/_i_l_T_y_p_e_s._h> Please refer to the _I_m_a_g_e_V_i_s_i_o_n _L_i_b_r_a_r_y _P_r_o_g_r_a_m_m_i_n_g _G_u_i_d_e for a full description of overall concepts and architecture. PPPPaaaaggggeeee 11111111 
